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• Written entirely in^ 

Derive your own object typesr Symbol 
Tables, Graphical Ob ect Lists, Pars 
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1 4 types of object, 
over 300 functions 

User's Guide 
explains object- 
oriented program- 
ming techniques, 
deriving your own 
object types, and 
includes tutorials 

Reference Guide 
with detailed infor- 
mation on each ob- 
ject type and 
function 

Demo and example 
programs 

Full source code 
available as option 

Debugging and 
production versions 
of libraries 

Support hot-line 

30 day, money back 
guarantee 



C+ OBJECTS™ is a portable, 
object-oriented C function 
library used to reduce 
the investment required 
to build complex software. 





What can C+OBJECTS 
do for me? 



It can give you more 
creative time to design 
programs because you'll 
spend less time coding 
and debugging them. 
That's because the 
fundamental data 
structures used in many 
programs have already 
been built for you. 
Volume 1 includes data 
structures such as 
doubly-linked lists, 
trees, dynamic arrays 
and graphs. Volume 2 
includes additional data 
structures such as 

ut lines, hash tables, 
stacks and queues 
(details on Volume 2 
appear in a separate 
brochure). 

Your programs will be 
more reliable with the 
sophisticated, multi-level 
exception-handler and 
debug libraries. 
You also get Julian 
(date) and String object 
types in our object- 



oriented format. The 
Julian routines have 
many calculations not 
available in other 
products. 

Can C+OBJECTS data 
structures be custom- 
ized? 

That's the whole idea! 
Customizing and 
extending the functions 
of C+OBJECTS data 
structures is simple. Just 
"inherit" functionality 
from one or more 
C+OBJECTS data 
structures and add your 
own code and data on 
top. 

For example, you could 
use the Tree data 
structure as the founda- 
tion for a parse tree. Or 
you might build a data 
structure for maintaining 
a graphical display list 
using the Doubly-Linked 
List object type. If you 
were building a data- 
flow diagram editor as 
part of a CASE package, 



you would find Graph, 
Vertex, and Edge well 
suited to the task. The 
uses for C+OBJECTS 
structures are virtually 
unlimited! 

Customizing or extend- 
ing C+OBJECTS object 
types does not involve 
modifying or recompil- 
ing the C+OBJECTS 
code or structures. 
C+OBJECTS would not 
be a useful tool other- 
wise. 

What do you mean by 
an "object-oriented" 
function library? 

Just as structured 
programming and 
structured design 
principles are not lan- 
guage dependent, 
neither are the principles 
of object-oriented pro- 
gramming. When we 
designed C+OBJECTS, 
we took the fundamental 
object-oriented 
programming techniques 
and applied them to C. 
Other object-oriented 
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tools for C have mim- 
icked the Smalltalk im- 
plementation, complete 
with all of Smalltalk's 
faults and inefficien- 
cies — we didn't, we 
married the best of both 
worlds. 

And Performance? 

C+OBJECTS is written 
entirely in C and does 
not use pre-processors or 
interpreters. Perform- 
ance is what sets 
C+OBJECTS apart from 
the others. 

C+OBJECTS provides 
macros for many 
functions. This gives 
you all the advantages of 
encapsulation without 
the performance penalty 
of calling a function to 
do a simple task. 

Additionally, the mes- 
saging and inheritance 
features are imple- 
mented in a manner 
tailor-made for C The 
result is cleaner and 
more efficient than 

mechanisms. 



Can it help me debug 
my programs faster? 

Yes! C+OBJECTS ad- 
vanced debugging 
features allow you to 
create reliable programs 
and do so easier and 
more quickly than you 
thought possible. 

First, C+OBJECTS uses 
function prototypes to 
catch simple errors at 
compile time involving 
incorrect type, wrong 
ordering or wrong 
number of parameters. 

Second, C+OBJECTS can 
detect when it is being 
passed a NULL or 
uninitialized pointer, 
pointers to the wrong 
type, or pointers to struc- 
tures which have been 
"garbaged". It also 
checks for illegal values 
in other parameters 
types. 

Third, C+OBJECTS in- 
cludes an advanced 
exception handler 
package. With it , you 
can set up a single (or 
multiple level) exception 
handler which traps 
exceptions generated by 
C+OBJECTS functions. 



If an exception is raised, 
you can determine the 
type and where it 
occurred. You can then 
recover from the excep- 
tion or abort, depending 
on which is most 
appropriate. Exception 
handlers can allow your 
program to be well 
behaved, even in the 
presence of bugs. 

This advanced error 
detection technique can 
be used in your own 
code as well. No longer 
do your programs need 
to check status codes 
after each function call. 
This results in less 
coding yet more reliable 
programs. 

Once your program has 
been debugged, you can 
use C+OBJECTS Produc- 
tion Libraries with macro 
functions . This elimi- 
nates most or all of the 
debugging checkpoints. 

What else can it do to 
increase my productiv- 
ity? 

C+OBJECTS goes 
beyond conventional 
function libraries by 
supplying a complete set 



of object-oriented 
control- structures. 
These functions allow 
you to traverse data 

structures without 

having to use for, while, 
or do-while statements. 

Control-structure 
functions simplify 
programs and eliminate 
a large number of poten- 
tial errors — boundary 
conditions in loops for 
example. 

Control-structure 
functions call a function 
of your choice for each 
item traversed. You can 
"inherit" these control- 
structure functions in 
your own data structures 
or create your own. 

How portable Is 
C+OBJECTS? 

C+OBJECTS was de- 
signed for portability to 
any operating system. 
Expect to see versions 
for Windows, OS/2, 
Presentation Manager, 
and Macintosh soon. 



Is it suitable as an / 
educational tool? 

Yes. , As an educational 
aid, it can teach you the 
principles of object- 
oriented programming. 
The User's Guide 
explains object-oriented 
programming and the 
differences between 
C+OBJECTS and Small- 
talk. It could even be 
used as a primer for C 
programmers who wish 
to understand more 
about Smalltalk. 

It can teach students the 
concepts of abstract data 
types and basic data 
structures. The linked 
list, tree, and graph types 
could form the founda- 
tion for a data structures 
class. 

A software engineering 
course would benefit 
from a study of 
C+OBJECTS. It demon- 
strates good design 
principles, strict naming 
and portability conven- 
tions, and defensive pro- 
gramming techniques. 

But don't let this fool 
you into thinking 
C+OBJECTS is only of 



educational value. 
C+OBJECTS is a serious 
development tool for 
professionals. 

What about source 
code, royalties etc.? 

Full source code is avail- 
able as an option. You 
will get more educa- 
tional value out of 
C+OBJECTS with the 
source, but you don't 
need it to fully use or 
understand the product. 
Source will of course be 
necessary if you are 
porting C+OBJECTS to a 
new environment — call 
us first though, we may 
be able to help. 

There are no royalties on 
programs developed 
using C+OBJECTS 
Volumes 1 or 2 and we 
do not require you to 
reproduce our copyright 
notice on your pro- 
grams. 

Call us for information 
on volume pricing, site 
licensing, and educa- 
tional discounts. 
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Class 



A Class (Cl$) implements the 
object-oriented properties 
inheritance and messaging. It 

is used to subclass another ob- 

■■ .. 

ject type. (See also Object 
page 11) 
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Doubly 
Linked List 

A Doubly-Linked List (Oil) ob- 
ject is used to represent the 
head and tail of a linked list A 
Dll contains objects of type 
List Element (or derivative 
objects). (See also List Ele- 
ment page 10) 
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CIsDefaultlnit 
ClsDestroyObj 
ClsGetClientOffset 
ClsGetGpMsgFunc 
CIsGetMsgFunc 
Clslnit 
ClsNewObj 
ClsSetClientOffcet 
ClsSendObjMsg 
OsSendObjGpMsg 



Initialize using defaults 

Deallocate object 

Return client offset 

Return (ptr.) message function ptr. 

Return (int) message function ptr. 

Initialize the class 

Allocate object 

Set client offset 

Send message, return int 

Send message, return pointer 



DllAppend 


Append element(s) to list 


DllAppendLast 


Append element(s) to end of list 


DllAppendOne 


Append one element to list 


DllAsObj 


Return list as object 


DllClear 


Clear list 


DllClient 


Return client of list 


DllClientDo 


Do function: all elements 


DtlClientDoBkwds 


Do function: elements backwards 


DllClientCount 


Do function: count elements 


DUCfientFind 


Do search function: all elements 


DllClientFirst 


Return client of first element 


DliClientGetNth 


Return Nth client 


DllClientOrNull 


Return client or null 


DllClientLast 


Return client of last element 


DllCut 


Cut element(s) from list 


DllCutAtl 


Cut all elements from list 


DllCutOne 


Cut one element from list 


DHDelnit 


Deinitialize list 


DllDestroy 


Deinitialize list, free space 


DllGetFirst 


Return first element 


DllGetLast 


Return last element 


DllGetNth 


Return Nth element 


DlllsEmpty 


Is list empty? 


Dlllnit 


Initialize list 


Dlttnsert 


Insert element(s) in list 



Doubly 
Linked List 



Dynamic 
Pointer 



: Dynamic Pointer Arrays 
j (Dpa) are useful for storing 
] arrays of pointers to objects of 
j any type. A Dpa is dynamic 
because storage for the array 
is allocated and reallocated 
dynamically as the size of the 
array changes ;f; 
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DlllnsertFirst Insert elements first 

DlUnsertOne Insert element in list 

DllMakeFirst Make element first 

DllMakeLast Make element last 

DUNew Initialize list object,allocate space 



DpaAppend 
DpaCut 
DpaClear 
DpaCountTrveReturns 
DpaDelnit 
Dpa Destroy 
Dpa Do 
DpaDoRange 
DpaDoRangeCheckRet 
DpaDoRegion 
DpaDoSelfAndSuccessors 
DpaFindBkwd 
DpaFindFrwd 
DpaFindPtrBkwd 
DpaFindPtrFrwd 
DpaFindRangeFrwd 
DpaFindRangeBkwd 
DpaCetLast 
DpaCetNth 
DpaCetSize 
Dpalnit 
DpaLoad 
DpaMakeElemen tsZero 
Dpa New 
Dpa Paste 
DpaScrollDo wn 
DpaScrollUp 
DpaSetNth 
DpaSetSize 



Append an element 
Delete element(s) 
Clear dynamic array 
Do function: count True returns 
Deinitialize dynamic array 
Deinitialize object, free all memory 
Do function: all elements 
Do function: range of elements 
Do function: range, check return 
Do function: region of elements 
Do function: successors 
Find index returning True 
Find index returning True 
Find index with matching pointer 
Find index with matching pointer 
Find index returning True for range 
Find index returning True for range 
Return last element in array 
Return Nth array element 
Return number of elements 
Initialize dynamic array object 
Load array by looping function 
Make range of elements null 
Initialize object and allocate space 
Paste element(s) into array 
Scroll down N lines in array 
Scroll up N lines in array 
Set Nth element of array 
Set array size to N elements 
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An Edge (Edg) is used to repre- 
sent a directed edge in a 
Graph (Grf). An edge can be 
connected and disconnected 
from two vertices (Vix). An 
edge can belong to a single 
graph. (See also Vertex page 
1 4 and Graph page 9) 
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Exception 
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An Exception (Exc) is a con- ■ + 
Earner for error/status infor- i + 
mation used when a program \ + 
wants to raise an exception. 
An Exc contains the type of 
error, its location, and other 
pertinent information. Excep- 
tions are invoked via a Thread 

Wf). 

(See ako Threads page 12) 



EdgClientDo 
EdgConnectToVertices 
EdgConnectToGrf 
EdgComparelnVtx 
EdgCompareOutVtx 
EdgDelnit 
EdgDisconnectFromGrf 
EdgGetClient 
EdgGetGraphLel 
EdgGetGrf 
EdgGetlnLel 
EdgGetlnVtx 
EdgGetNextin 
EdgGetNextOut 
EdgGetOutLel 
EdgGetOutVtx 
EdgGetVertices 
Edglnit 
EdglnGrf 
EdgNew 
EdgSendDestroy 
EdgUpdatelnVtx 
EdgUpdateOutVtx 



ExcClear 
ExcDetnit 
ExcDestroy 
ExcGetCode 
ExcGetFile 
ExcGetLine 
ExcGetOpSysErr 
ExcGetType 
ExclnH 
ExclsFatal 
ExcNew 
ExcSet 



Do function: edge 
Connect edge to vertices 
Connect edge to graph 
Compare vertex to incoming edge 
Compare vertex with outgoing edge 
Detnitialize the edge object 
Disconnect edge from graph 
Return client of edge 
Return as graph list element 
Return graph 

Return incoming edge list element 
Return incoming vertex 
Return next incoming edge 
Return next outgoing edge 
Return outgoing edge list element 
Return outgoing vertex 
Return vertices to edge 
Initialize the edge object 
Is edge in graph? 

Initialize edge object and allocate 
Send message for vertex destruction 
Replace incoming vertex 
Replace outgoing vertex 



Clear exception 

Deinitialize exception 

Deinitialize exception, free space 

Return error code 

Return file where error detected 

Return line where error detected 

Return system error code 

Return type of error 

Initialize exception 

Is exception non-recoverable? 

Initialize exception, allocate space 

Set exception fields 



Graph 
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4 Graph (Crf) object is used to j + 
represent a directed graph (or ; + 
digraph) as understood by j + 
graph theory, A Graph is a \ 
collection of Vertices (Vtx) [ + 
and (directed) Edges (Edg). A ! + 
grapft can 6e sorted topologi- ] + 
ca//y to determine if it isacyr | + 
die. (See also Vertex page, 14 I 
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and Edge page 8) 



GrfAddEdg 
GrfAddVtx 
GrfClear 
GrfCountEdg 
GrfCountVtx 
GrfDestroy 
GrfDelnit 
GrfDoEdgClient 
GrfDoVtxClient 
GrfDoVtxInTopOrder 

Grflnit 
GrfNew 
GrfRemoveEdg 
GrfkemoveVtx 
GriTopologicalSort 



Add edge to graph 
Add vertex to graph 
Clear the graph 
Count edges of graph 
Count vertices of graph 
Deinitialize graph and free space 
Deinitialize graph object 
Do function: edges 
Do function: vertices 
Do function: vertices in topological 
. order 
Initialize graph object 
Initialize graph allocate space 
Remove edge from graph 
Remove vertex from graph 
Do topological sort of graph 



Julian Date 

A Julian Da te (Jul) & used to 
represent a specific day in a 
specific year. The representa- 
tion is purposely made ex- 
plicit by its name/ This repre- 
sentation of dates is most ap- 
propriate when date calcula- 
tions are of more interest than 
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JulAddDays 
JulAddDaysL 
JulAddMonths 
JulAddQuarters 
JulAddYears 
JulToCalendar 
JulCopy 
JulDateStrTofulian 
JulDayslnMonth 
JulDayslnQuarter 
JulDayslnYear 
JulDayOfYear 
fulDayOfWeek 
JulDiff 
JulDiffL 
JulFromCalendar 
JulGetMaxVaJue 
JulGetSystemJulianDay 



JuIlsLeapYear 
JullsMaxVatue 



Add/subtract days to date 

Add/subtract days to date (long) 

Add/subtract months to date 

Add/subtract quarters to date 

Add/subtract years to date 

Julian day to day, month, year 

Copy julian day 

Date string to julian day 

Days in month 

Days in quarter 

Days in year 

Day number in year 

Day number in week 

Days between two dates 

Days between two dates (long) 

Day, month, year to julian 

dayReturn maximum julian value 

System date as julian day 

Initialize object 

Is date in leap year? 

is date maximum julian value? 
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Julian Datm l 

A Julian Date (Jul) is used to 
represent a specific day in a 
specific yean The representa- \ 
tidn is purposely made ex- 
I pficit by its name, This repre- 
sentation of dates is most ap- j 
propriate when date calcula- 
tions are of more interest than 
formatting. (Continued from 
page 9) 



List Element 



A List Element (Let) object is 
used to maintain membership ; 
in a doubly-linked list (Dll). A 
Lei knows its previous and 



nex 



next list elements and the list 
it belongs to, if any. (See also} 
Doubly-Linked List page 6) 
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lulMax 
JulMin 
lutMonthDayDiff 
JulMonthString 
JulQuarterString 
JutSameDayMonth 
lulSetMaxDate 
JulToDateStr 
JulValidateDate 
JulWeekString 
JulYearString 



LelAppend 
LelAsObj 
LelClientDll 
LelClientNext 
LelCtientPrev 
LetClientCountSelfAndSuccessors 
LelCtientDoSelfAndPredecessors 
LetCtientDoSetfAndSuccessors 
LetClientDoPredecessors 
LelCtientDoSuccessors 
LelClientDoRange 
LelCtientFindRange 
LelCount 
LelCut 
LelDelnit 
LelDoRange 
LelElementsArelnOrder 
LetGetClient 
LeiCetDtl 
LelGetNthSuccessor 
LelGetNext 
LelGetPrev 
Lellnit 
LeltnList 
Leiinsert 
LelMakeList 



The maximum of two Julian dates 
The minimum of two julian dates 
Days between date and day/month 
Fill string with month and year 
Fill string with quarter and year 
Are dates same day and month? 
Set date to maximum value 
Fill date string with specified format 
Validate date passed as string 
Fill string with week 
Fill string with year 



Append elements(s) to list 

Return element as object 

Return client of list 

Return client of next element 

Return client of previous element 

Return count of successors 

Do function: predecessors 

Do function: successors 

Do function: predecessors 

Do function: successors 

Do function: range 

Do search function: range 

Count elements 

Cut element(s) from list 

Deinitialize list element object 

Do function: for range 

Are two elements in order? 

Return client 

Return list object is in 

Return Nth successor element 

Return next element 

Return previous element 

Initialize list element object 

Is element in list? 

Insert elements) to list 

Make elements into list 



Object 



\ An Object (Obj) implements 
\ the object-oriented proper- 
: ties of inheritance and mes- 
I saging, It is of use for imple- 
\ menting reusable data types 
(as opposed to application- 
j. specific types). (See also Class 
0 



String 
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The String (Str) class b used to 
represent null terminated 
character arrays. -' 



Task 
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A Task (Tsk) object is used to ; + 
represent a program. A Tsk |+ 
owns all the threads in that 
task (one in MS-DOS). A task 
contains information used to 
invoke me program and other 
global information which be- 
longs to a task. (See also 
Thread page 12 and Exception 
page 8) 
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ObjDelnrt 
ObjDestroyCtient 
ObjGetClientOrNull 
ObjCetCpMsgFunc 
ObjGetMsgFunc 
ObjGetClient 
Objlnit 
ObjSetClient 
ObjSendClientGpMsg 
ObjSendClientMsg 



StrAsMediumlnt 
StrExtract 
StrFromMediumlnt 
StrHash 
StrReplaceSubStr 
StrSqueez 
StrToLower 
StrToUpper 



TskDelnit 
TskDestroy 
TskExit 
TskBx'rtWithMsg 
Tsklnit 
TskNew 



Deinitialize object 
Deallocate object 
Return client 

Return (ptr.) message function 
Return (int) message function 
Return client of subclass 
Initialize object 
Set client 

Send client a (ptr.) message 
Send client a (int) message 



String to 1 6 bit integer 
Extract substring from string 
Integer to string 
Return hash value of string 
Replace substring in string 
Removes any character from string 
Change case of string to lower 
Change case of string to upper 



Deinitialize task 

Deinitialize task and free space 

Exit task with code 

Exit task after displaying message 

Initialize task 

Initialize task and allocate space 
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Thread 

A Thread (Thr ) is used to rep- 
resent a single thread-of-con- 

! fro/ (s/m/far to OS/2>. How- 

f ever, MS-DOS implements 

\ only single threaded pro- 
grams, therefore there is only 
one instance of a Thr. The 
only use threads have cur- 

i rently, is as a mechanism for 
pushing, popping, and invok- 

I ing exception handlers (in the 
Ada style). Typically, a pro- 

j gram might set up a single 
exception handler via Thr 
which traps any program logic 
errors (are triggered with 

| "assertsj. (See also Task page 
1 1 and Exception page S) 



Tree 



i structure that may contain 
zero or more children trees 
and zero or one parent trees. 
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ThrBadParameter 
ThrClear 
ThrDisablePushAndPop 
ThrDiskFull 
ThrDelnit 
ThrEndOfFile 
ThrEnablePvsbAndPop 
ThrFatalLogicError 
Thrlnit 
ThrlsFatalError 
Thrlslnitialized 
ThrOpSysError 
ThrOutOfMemory 
ThrPopCtx 
ThrPushErfAndRetum 
ThrPushCtx 
ThrRetumStatus 
ThrWaming 



TreAppChild 
TreAppSibling 
TreAsDU 
TreAsLel 
TreAsObj 
TreClient 
TreClientNextSequential 
TreClient DoAUSuccessors 
TreClientDoBreadtbEirst 
TreClientDoBranchDepthFirst 
TreClientDoChildren 
TreClientDoChildrenBkwds 
TreClientDoOepthFirst 
TreClientDoDepthFirstBkwds 
TreClientDoDescBranchDepthFirst 
TreClientDoDescBreadthFirst 
TreClientDoDescDepthFirst 
TreClientDoDescDepthFirstBkwds 
TreClientDoDescLeaves 
TreClientDoLeaves 



Signal bad function parameter 

Clear thread 

Disable further signaling 

Signal disk full 

Deinitialize thread object 

Signal end of file 

Enable signaling 

Signal program logic error 

Initialize thread object 

Is exception non-recoverable? 

Is thread initialized? 

Signal system error 

Signal out of memory 

Pop to previous exception handler 

Invoke current exception handler 

Push new exception handler 

Signal status condition 

Signal warning 



Append child(ren) 

Append sibling(s) 

Return tree as linked list 

Return tree as list element 

Return tree as object 

Return client of tree 

Return next sequential client tree 

Do function: all successors 

Do function: breadth first 

Do function: branch depth first 

Do function: children, forwards 

Do function: children, backwards 

Do function: depth first 

Do function: depth first, backwards 

Do function: descendent branches 

Do function: descendent breadth 

Do function: descendent depth 

Do function: descendent depth 

Do function: descendent leaves 

Do function: leaves 
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Tree 



A tree is a recursive data 
structure that may contain 
zero or more children trees 
and zero or one parent trees. 
(Continued from page 12) 
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TreClientDoParentsNearestFirst 
TreClientDoRange 
TreClientDoSuccessors 
TreCtientFindChild 
TreCUentFirstChild 
TreClientLastChild 
TreClientLastLeaf 
TreClientNext 
TreClientNextUncle 
TreClientParent 
TreClientPrev 
TreClientPrevSequential 
TreCut 
TreCutChildren 
TreDetnH 
TreDoAllSuccessors 
TreDoBranchDepthFirst 
TreDoBreadthFirst 
TreDoChildren 
TreDoChitdrenBkwds 
TreDoDepthFirst 
TreDoDepthFirstBkwds 
TreDoDescBranchDepthFirst 
TreDoDescBreadthFirst 
TreDoDescDepthFirst 
TreDoDescDepthFirstBkwds 
TreDoDescLeaves 
TreDoLeaves 
TreDoRange 
TreDoSuccessors 
TreFirstChild 
TreHasChildren 
TreHasSiblings 
Trelnit 
TretsChild 
TrelsDirectAncestor 
TrelsRoot 
TrelnsChild 
TrelnsSibling 
TreLastOtild 



Do function: nearest parents first 

Do function: range 

Do function: successors 

Do search function: children 

Return client of first child 

Return client of last child 

Return client of last leaf 

Return client of next sibling 

Return client of next uncle 

Return client of parent 

Return client of previous sibling 

Return previous client sequentially 

Cut node(s) from tree 

Cut children from tree 

Deinitialize tree object 

Do function: successors 

Do function: branches depth first 

Do function: breadth first 

Do function: children 

Do function: children backwards 

Do function: depth first 

Do function: depth first backwards 

Do function: descendent branches 

Do function: descendent breadth 

Do function: descendent depth 

Do function: descendent depth 

Do function: descendent leaves 

Do function: leaves 

Do function: range 

Do function: successors 

Return first child 

Does tree have any children? 

Does tree have any siblings? 

Initialize tree object 

Is tree a child? 

Is related related to another? 

Is tree the root? 

Insert child(ren) 

Insert sibling(s) 

Return last child 
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Tree 



\ A tree is a recursive data 
\ structure that may contain 
( zero or more children trees 
\ and zero or one parent trees. 

(Continued from page 13) 
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Vertex 

A Vertex (Vtx) is used to repre- 
sent a node in a directed graph ] 
(Grf). A vertex can belong to 
a single graph. It tan access ; 
each of its incoming (arrow- \ 
end) edges (Edg) and each of 
its outgoing edges. It can also 
access all its predecessor ver- 
tices and successor vertices. 
(See also Graph page 9 and 
Edge page 8) 
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TreLastLeaf 
TreNew 
TreNext 
TreNextSequential 
TreNextUncle 
TreParent 
TrePrev 
TrePrevSequential 
TreSendMsg 
TreSendGpMsg 

VtxAddlnEdg 
VtxAddOutEdg 
VtxClear 
VtxConnectToGrf 
VtxCountln 
VtxCountOut 
VtxDisconnect 
VtxDoEdge 
VtxDoEdgeClients 
VtxDolnEdge 
VtxDolnEdgeClient 
VtxDoOutEdge 
VtxDoOutEdgeClient 
VtxDelnit 
VtxDestroy 
VtxDisconnectFromGrf 
VtxFindOutEdg 
VtxFindOutEdgClient 
VtxGetClient 
VtxGetFirstln 
VtxGetFirstOut 
VtxGetGraphLel 
VtxGetGrf 
VtxInGrf 
Vtxlnit 
VtxNew 
VtxRemovelnEdg 
VtxRemoveOutEdg 
VtxSendClientMsg 



Return last leaf 

Allocate and initialize tree object 
Return next sibling 
Return next sequential tree 
Return next uncle 
Return parent 
Return previous sibling 
Return previous sequential tree 
Send a int message to client 
Send a ptr. message to client 

Add incoming edge 

Add outgoing edge 

Clear vertex 

Connect vertex to graph 

Count incoming edges 

Count outgoing edges 

Disconnect vertex from graph 

Do function: all edges 

Do function: clients of all edges 

Do function: incoming edges 

Do function: incoming edges 

Do function: outgoing edges 

Do function: outgoing edges 

Deinitialize vertex object 

Deinitialize vertex object and free 

Disconnect vertex from graph 

Do search function: outgoing edges 

Do search function: outgoing edges 

Return client of vertex 

Return first incoming edge 

Return first outgoing edge 

Return as list element in graph 

Return graph 

Is vertex in graph? 

Initialize vertex object 

Initialize vertex, allocate space 

Remove incoming edge 

Remove outgoing edge 

Send message to client 



r The following program fragment demonstrates inheritance from the Tree object type. It is not complete 
but is representative of the use of C+OBJECTS7 

struct Node { r Node is a specialized kind of Tree 7 

char 'name; r Name for each node 7 

Tree tre; /* Node Inherits from Tree 7 

};typedef struct Node Node; 
Node 'pNodR = {0} ; f The root node 7 

Claw NodeCU = {0}, 'NodTreCIs = &NodeCls; /* To inherit from Tree, we need a "class" describing Node V 

tnt main() { 

Nodlnitia!izeModule(); r Initialize classes 7 

NodBuildTree(); /* Create a sample set of tree nodes 7 

r "TreCiientDo" functions win call a function, Nod Print in these examples, 

and pass the "client* of the tree, a Node pointer in this case, for each tree/node visited 7 
r Print the children nodes of root: a b c 7 

TreCllentDoChiIdren( 4pNodR->tre, Nod Print ); printf( "\n" ); t* Object-oriented control-structure 7 
f Print the nodes in depth first order: root a.1 a. 2 a b c 7 

TreClientDoDepthFirsq &pNodR->tre, NodPrint ); printf( "Vr ); r Object-oriented control-structure 7 

» 



void NodBuildTree( void ) { t Builds a sample tree of nodes 7 

Node'pNod, *pNoda; 

pNodR = NodNew( "roor ); f Create the root node 7 

pNoda = NodNew( "a" ); NodAppChild( pNodR, pNod ); 

pNod = NodNew( "b" ); NodAppChild( pNodR, pNod ); 

pNod o NodNew( "c" ); NodAppChild( pNodR, pNod ); 

pNod = NodNew( "a. V ); NodAppChiW( pNoda, pNod ); r Note: we are adcf ng to pNoda 7 

pNod = NodNew( 'a.2" ); NodAppChild( pNoda, pNod ); r Ditto 7 

) 



Node *NodNew( char *name ) { r Allocate memory for a new node and initialize it 7 

Node # pNod; 

pNod = (Node *) maJloc< sizeof (Node) ); 

Trelnlt( &pNod->tre, NodTreCIs, (char *) pNod ); r InlUalize the tree. Trelnlt needs a class and Instance: the "clienr V 
p Nod- > name = name; 

} 



void NodAppChild( Node *pNodP, Node # pNodC ) { r Inherit the Tree function TreAppChild 7 
TreAppChHd( ApNodP->tre, &pNodC->tre, & P NodO>tre ); /• This adds pNodC as the last child of the parent pNodP 7 

) 



void NodPrint( Node *pNod ) ( f Print a node name given a Node pointer 7 
printf( "%s pNod->name ); 

) 



void Nod!nitiaJizeModule{ void ) ( r Initialize the class which describes Nodes 7 
ClsDefauttlnit( NodTreCIs ); r DefaulUnit uses a default class description 7 

} 
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Tech Specs 




WPE OF LIBRARY: 



+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 



Number of Classes: 



Number of Functions: 



Object-Oriented Data 
Structures, Abstract Data 
Types, Exception 
Handler, Date and String 

18 

over 300 



Compilers: 



+ 
+ 
+ 



Microsoft C 5.0 + 
QuickC 2.0 + 
Turbo C 2.0 



Operating 
Environments: 



+ Memory Models: 



DOS 

Windows 
OS/2 
Xenix 
Sun Unix 

All models 



+ Version: 



2.0 



C+Objects is engineered and published by 
Objective Systems 
Architects and Engineers of Software 

2443 Fillmore Street 
San Francisco / California / 941 15 

C+Objects is a trademark of Objective Systems 



PHONE 415/929-0964 FAX 415/929-8015 
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